home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 December / PCWorld_1999-12_cd.bin / Software / Servis / UrthMDB / sockdb / USDB File Specs.ht_ / USDB File Specs.ht
Text File  |  1999-10-03  |  22KB  |  482 lines
  1. <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
  2. <html>
  3.  
  4. <head>
  5. <meta http-equiv="Content-Type"
  6. content="text/html; charset=iso-8859-1">
  7. <meta name="GENERATOR" content="Microsoft FrontPage 2.0">
  8. <title>Import and Export Specifications</title>
  9. </head>
  10.  
  11. <body bgcolor="#A3CDDA">
  12. <div align="center"><center>
  13.  
  14. <table border="1" cellpadding="8" cellspacing="0" width="100%"
  15. bgcolor="#5A8BAB">
  16.     <tr>
  17.         <td align="center" width="100%"><font color="#FFFF00"
  18.         size="6" face="Arial"><em><strong>Urthman's Sockets
  19.         Database</strong></em></font></td>
  20.     </tr>
  21. </table>
  22. </center></div><div align="center"><center>
  23.  
  24. <table border="0" cellpadding="4" cellspacing="4" width="100%">
  25.     <tr>
  26.         <td align="center"><font size="4" face="Arial"><strong>Import
  27.         and Export Specifications</strong></font></td>
  28.     </tr>
  29. </table>
  30. </center></div>
  31.  
  32. <hr>
  33. <div align="center"><center>
  34.  
  35. <table border="0" cellpadding="8" cellspacing="0" width="90%">
  36.     <tr>
  37.         <td align="right" valign="top" width="30%"><a
  38.         href="#Import"><font face="Arial"><strong>Import
  39.         Specifications</strong></font></a></td>
  40.         <td width="70%"><font size="2" face="Arial">Describes the
  41.         format necessary for importing data. Generally, files
  42.         formatted similarly to your existing services file should
  43.         be ready to import.</font></td>
  44.     </tr>
  45.     <tr>
  46.         <td align="right" valign="top" width="30%"><a
  47.         href="#Initial"><font face="Arial"><strong>Initialization
  48.         Listings</strong></font></a></td>
  49.         <td width="70%"><font size="2" face="Arial">Describes the
  50.         files absorbed the first time the program is executed,
  51.         and what to do about updated or corrective versions and
  52.         new RFC releases.</font></td>
  53.     </tr>
  54.     <tr>
  55.         <td align="right" valign="top" width="30%"><a
  56.         href="#Export"><font face="Arial"><strong>Export
  57.         Specifications</strong></font></a></td>
  58.         <td width="70%"><font size="2" face="Arial">Describes
  59.         what to expect when exporting the database contents.</font></td>
  60.     </tr>
  61.     <tr>
  62.         <td align="right" valign="top" width="30%"><a
  63.         href="#Oops"><font face="Arial"><strong>Recovering from
  64.         ...</strong></font></a></td>
  65.         <td width="70%"><font size="2" face="Arial">Describes how
  66.         to recover the original data in the event that your data
  67.         gets screwed up.</font></td>
  68.     </tr>
  69. </table>
  70. </center></div>
  71.  
  72. <hr>
  73.  
  74. <p><a name="Import"><font face="Arial"><strong>Import
  75. Specifications:</strong></font></a><font face="Arial"> </font><font
  76. size="2" face="Arial">For the most part, the format for importing
  77. the /etc/services tables conforms to a typical /etc/services file
  78. and the listings in the RFC-1060 and 1700 documents with some
  79. minor exceptions. Please read through this material before
  80. proceeding since some minor (and harmless) editting might be
  81. required.</font></p>
  82.  
  83. <p><font size="2" face="Arial">Importing a file allows users to
  84. exchange and share data with common references. If any given
  85. record exists, the references are simply updated. Importable
  86. files can also be used to mask or delete usage references. After
  87. such an exercise, a quick sweep through the database will delete
  88. all records whose usage flags are left blank by the
  89. import-to-delete process.</font></p>
  90.  
  91. <hr>
  92. <div align="left">
  93.  
  94. <table border="0" cellpadding="6" cellspacing="0" width="100%"
  95. bgcolor="#FFFFFF">
  96.     <tr>
  97.         <td align="right" bgcolor="#008080"><font color="#00FFFF"
  98.         face="Arial"><strong>Importing</strong></font></td>
  99.         <td bgcolor="#008080"><font color="#00FFFF" face="Arial"><strong>Data</strong></font></td>
  100.         <td align="right" bgcolor="#008080"> </td>
  101.         <td bgcolor="#008080"> </td>
  102.         <td bgcolor="#008080"> </td>
  103.         <td bgcolor="#008080"> </td>
  104.     </tr>
  105.     <tr>
  106.         <td align="right" bgcolor="#C0C0C0"> </td>
  107.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>keyword</strong></font></td>
  108.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>port/protocol</strong></font></td>
  109.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><aliases></strong></font></td>
  110.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><#comment></strong></font></td>
  111.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><[References]>
  112.         </strong></font></td>
  113.     </tr>
  114.     <tr>
  115.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  116.         face="Arial"><strong>Normal:</strong></font></td>
  117.         <td><font size="2" face="Courier New">nntp</font></td>
  118.         <td><font size="2" face="Courier New">119/tcp</font></td>
  119.         <td><font size="2" face="Courier New">usenet</font></td>
  120.         <td><font size="2" face="Courier New"># news-reader </font></td>
  121.         <td><font size="2" face="Courier New">[65,PL4]</font></td>
  122.     </tr>
  123.     <tr>
  124.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  125.         face="Arial"><strong>Import Alias:</strong></font></td>
  126.         <td><font size="2" face="Courier New">untp</font></td>
  127.         <td><font size="2" face="Courier New">119/tcp</font></td>
  128.         <td> </td>
  129.         <td><font size="2" face="Courier New"># follows nntp for
  130.         alias</font></td>
  131.         <td> </td>
  132.     </tr>
  133.     <tr>
  134.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  135.         face="Arial"><strong>Import Range:</strong></font></td>
  136.         <td><font size="2" face="Courier New">x11</font></td>
  137.         <td><font size="2" face="Courier New">6000-6063/tcp</font></td>
  138.         <td> </td>
  139.         <td><font size="2" face="Courier New"># X Window System</font></td>
  140.         <td> </td>
  141.     </tr>
  142.     <tr>
  143.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  144.         face="Arial"><strong>Also -- UDP:</strong></font></td>
  145.         <td><font size="2" face="Courier New">x11</font></td>
  146.         <td><font size="2" face="Courier New">6000-6063/udp</font></td>
  147.         <td> </td>
  148.         <td><font size="2" face="Courier New"># X Window System</font></td>
  149.         <td> </td>
  150.     </tr>
  151.     <tr>
  152.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  153.         face="Arial"><strong>TCP and UDP:</strong></font></td>
  154.         <td><font size="2" face="Courier New">x11</font></td>
  155.         <td><font size="2" face="Courier New">6000-6063</font></td>
  156.         <td> </td>
  157.         <td><font size="2" face="Courier New"># X Window System</font></td>
  158.         <td> </td>
  159.     </tr>
  160.     <tr>
  161.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  162.         face="Arial"><strong>No Keyword:</strong></font></td>
  163.         <td> </td>
  164.         <td><font size="2" face="Courier New">24/tcp</font></td>
  165.         <td> </td>
  166.         <td><font size="2" face="Courier New"># any private mail
  167.         system</font></td>
  168.         <td> </td>
  169.     </tr>
  170.     <tr>
  171.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  172.         face="Arial"><strong>Comment:</strong></font></td>
  173.         <td> </td>
  174.         <td> </td>
  175.         <td> </td>
  176.         <td colspan="2"><font size="2" face="Courier New">#
  177.         appended to the previous comment</font></td>
  178.     </tr>
  179.     <tr>
  180.         <td align="right" bgcolor="#008080"><font color="#00FFFF"
  181.         face="Arial"><strong>Reserved</strong></font></td>
  182.         <td bgcolor="#008080"><font color="#00FFFF" face="Arial"><strong>Ports</strong></font></td>
  183.         <td align="right" bgcolor="#008080"> </td>
  184.         <td bgcolor="#008080"> </td>
  185.         <td bgcolor="#008080"> </td>
  186.         <td bgcolor="#008080"> </td>
  187.     </tr>
  188.     <tr>
  189.         <td align="right" bgcolor="#C0C0C0"> </td>
  190.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>keyword</strong></font></td>
  191.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>port/protocol</strong></font></td>
  192.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><aliases></strong></font></td>
  193.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><#comment></strong></font></td>
  194.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><[References]>
  195.         </strong></font></td>
  196.     </tr>
  197.     <tr>
  198.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  199.         face="Arial"><strong>Reserved:</strong></font></td>
  200.         <td> </td>
  201.         <td><font size="2" face="Courier New">0/tcp</font></td>
  202.         <td> </td>
  203.         <td><font size="2" face="Courier New"># Reserved </font></td>
  204.         <td> </td>
  205.     </tr>
  206.     <tr>
  207.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  208.         face="Arial"><strong>Reserved:</strong></font></td>
  209.         <td> </td>
  210.         <td><font size="2" face="Courier New">240-245/udp</font></td>
  211.         <td> </td>
  212.         <td><font size="2" face="Courier New"># Reserved</font></td>
  213.         <td> </td>
  214.     </tr>
  215.     <tr>
  216.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  217.         face="Arial"><strong>TCP and UDP:</strong></font></td>
  218.         <td> </td>
  219.         <td><font size="2" face="Courier New">240-245</font></td>
  220.         <td> </td>
  221.         <td><font size="2" face="Courier New"># Reserved</font></td>
  222.         <td> </td>
  223.     </tr>
  224.     <tr>
  225.         <td align="right" bgcolor="#008080"><font color="#00FFFF"
  226.         face="Arial"><strong>Unassigned</strong></font></td>
  227.         <td bgcolor="#008080"><font color="#00FFFF" face="Arial"><strong>Ports</strong></font></td>
  228.         <td align="right" bgcolor="#008080"> </td>
  229.         <td bgcolor="#008080"> </td>
  230.         <td bgcolor="#008080"><font color="#00FFFF" face="Arial"><strong>(ignored)</strong></font></td>
  231.         <td bgcolor="#008080"> </td>
  232.     </tr>
  233.     <tr>
  234.         <td align="right" bgcolor="#C0C0C0"> </td>
  235.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>keyword</strong></font></td>
  236.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>port/protocol</strong></font></td>
  237.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><aliases></strong></font></td>
  238.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><#comment></strong></font></td>
  239.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><[References]>
  240.         </strong></font></td>
  241.     </tr>
  242.     <tr>
  243.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  244.         face="Arial"><strong>Unassigned:</strong></font></td>
  245.         <td> </td>
  246.         <td><font size="2" face="Courier New">8/udp</font></td>
  247.         <td> </td>
  248.         <td><font size="2" face="Courier New"># Unassigned</font></td>
  249.         <td> </td>
  250.     </tr>
  251.     <tr>
  252.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  253.         face="Arial"><strong>Unassigned:</strong></font></td>
  254.         <td> </td>
  255.         <td><font size="2" face="Courier New">3000-3011/tcp</font></td>
  256.         <td> </td>
  257.         <td><font size="2" face="Courier New"># Unassigned</font></td>
  258.         <td> </td>
  259.     </tr>
  260.     <tr>
  261.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  262.         face="Arial"><strong>TCP and UDP:</strong></font></td>
  263.         <td> </td>
  264.         <td><font size="2" face="Courier New">3000-3011</font></td>
  265.         <td> </td>
  266.         <td><font size="2" face="Courier New"># Unassigned</font></td>
  267.         <td> </td>
  268.     </tr>
  269.     <tr>
  270.         <td align="right" bgcolor="#008080"><font color="#00FFFF"
  271.         face="Arial"><strong>Deleting</strong></font></td>
  272.         <td bgcolor="#008080"><font color="#00FFFF" face="Arial"><strong>Ports</strong></font></td>
  273.         <td align="right" bgcolor="#008080"> </td>
  274.         <td bgcolor="#008080"> </td>
  275.         <td bgcolor="#008080"><font color="#00FFFF" face="Arial"><strong>(references
  276.         removed)</strong></font></td>
  277.         <td bgcolor="#008080"> </td>
  278.     </tr>
  279.     <tr>
  280.         <td align="right" bgcolor="#C0C0C0"> </td>
  281.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>keyword</strong></font></td>
  282.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong>port/protocol</strong></font></td>
  283.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><aliases></strong></font></td>
  284.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><#comment></strong></font></td>
  285.         <td bgcolor="#C0C0C0"><font size="2" face="Courier New"><strong><[References]>
  286.         </strong></font></td>
  287.     </tr>
  288.     <tr>
  289.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  290.         face="Arial"><strong>Delete Refs:</strong></font></td>
  291.         <td> </td>
  292.         <td><font size="2" face="Courier New">3000/tcp</font></td>
  293.         <td> </td>
  294.         <td><font size="2" face="Courier New"># Delete </font></td>
  295.         <td> </td>
  296.     </tr>
  297.     <tr>
  298.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  299.         face="Arial"><strong>Delete Refs:</strong></font></td>
  300.         <td> </td>
  301.         <td><font size="2" face="Courier New">3000-3024/udp</font></td>
  302.         <td> </td>
  303.         <td><font size="2" face="Courier New"># Delete</font></td>
  304.         <td> </td>
  305.     </tr>
  306.     <tr>
  307.         <td align="right" bgcolor="#C0C0C0"><font size="2"
  308.         face="Arial"><strong>TCP and UDP:</strong></font></td>
  309.         <td> </td>
  310.         <td><font size="2" face="Courier New">3000-3024</font></td>
  311.         <td> </td>
  312.         <td><font size="2" face="Courier New"># Delete</font></td>
  313.         <td> </td>
  314.     </tr>
  315. </table>
  316. </div>
  317.  
  318. <hr>
  319.  
  320. <ul>
  321.     <li><font size="2" face="Arial">All records that include a
  322.         keyword need to be left justified (no leading spaces).</font></li>
  323.     <li><font size="2" face="Arial">All records that do not
  324.         include a keyword require at least one leading space</font></li>
  325.     <li><font size="2" face="Arial">Each element must have at
  326.         least one space before the next element unless preceeded
  327.         by a delimiter </font></li>
  328.     <li><font size="2" face="Arial">Maximum of 4 aliases per
  329.         record (import restriction only) </font></li>
  330.     <li><font size="2" face="Arial">A "-" must separate
  331.         "from" and "to" port numbers in a
  332.         range (no spaces)</font></li>
  333.     <li><font size="2" face="Arial">A "/" must separate
  334.         port and protocol (no spaces)</font></li>
  335.     <li><font size="2" face="Arial">A "#" character
  336.         must preceed the comments</font></li>
  337.     <li><font size="2" face="Arial">References must be enclosed
  338.         in '[' and ']'</font></li>
  339.     <li><font size="2" face="Arial">Comments that include braces
  340.         ('[' and ']') will cause some comment data copied into
  341.         the references field. under these conditions, you should
  342.         change these to parentheses.</font></li>
  343.     <li><font size="2" face="Arial">Column alignment is
  344.         irrelevant providing the proper spaces and delimiters are
  345.         in the correct sequence.</font></li>
  346. </ul>
  347.  
  348. <p><font size="2" face="Arial"><strong>Note:</strong> The import
  349. function requires that you select at least one category to import
  350. to. If the record already exists for that port/protocol, the
  351. reference is updated.</font></p>
  352.  
  353. <p><font size="2" face="Arial">You can also use the import
  354. function to bulk-delete references to a series of port/protocol
  355. assignments. Such an action will result in a subsequent sweep to
  356. delete all port/protocol assignments that no longer have any
  357. associated category.</font></p>
  358.  
  359. <hr>
  360.  
  361. <p><a name="Initial"><font face="Arial"><strong>Initialization
  362. Listings:</strong></font></a><font face="Arial"> </font><font
  363. size="2" face="Arial">When the program is started for the very
  364. first time, some pre-fabricated data is imported from the 'INIT'
  365. subdirectory found within the programs folder. This
  366. pre-fabricated data includes RFC-1060, RFC-1700 and Unix
  367. Standards data. The program then locates your Windows SERVICES
  368. file and imports that also.</font></p>
  369.  
  370. <p><font size="2" face="Arial">The files in the INIT folder have
  371. the letter 'a' at the end of the files name to denote a version
  372. or release. Any updated or corrective listing files (either
  373. provided by John Stanley Enterprises or obtained through other
  374. sources) can be placed in the folder and named similarly with a
  375. different letter behind them. Each time the program runs it looks
  376. for new files in this folder to update the RFC-1060, RFC-1700 or
  377. UNIX-STD listings, and to add any new RFC numbered listings that
  378. may arise in the future.</font></p>
  379.  
  380. <p><font size="2" face="Arial">If a new RFC concerning assigned
  381. numbers is released:</font></p>
  382.  
  383. <ol>
  384.     <li><font size="2" face="Arial">Format the section involving
  385.         the port assignments in a manner that fits the import
  386.         specifications.</font></li>
  387.     <li><font size="2" face="Arial">Name the file
  388.         "RFC-XXXXa" (with no extension) where 'XXXX' is
  389.         the RFC number.</font></li>
  390.     <li><font size="2" face="Arial">Place the file in the INIT
  391.         folder and start the program.</font></li>
  392. </ol>
  393.  
  394. <p><font size="2" face="Arial">A new category (RXXXX where 'XXXX'
  395. is the RFC number) will be created, and the data will be imported
  396. with the appropriate references to the new category.</font></p>
  397.  
  398. <hr>
  399.  
  400. <p><a name="Export"><font face="Arial"><strong>Export
  401. Specifications:</strong></font></a><font face="Arial"> </font><font
  402. size="2" face="Arial">The export data is always written to
  403. <application path>\etc\<filename></font></p>
  404.  
  405. <p><font size="2" face="Arial">The export format should be pretty
  406. much the same as your /etc/services file. The overall format
  407. would resemble the format described in the table above except
  408. that the unassigned and deleted records will not be included.</font></p>
  409.  
  410. <p><font size="2" face="Arial">The export options include:</font></p>
  411.  
  412. <ul>
  413.     <li><font size="2" face="Arial">Include Aliases in the
  414.         Aliases column. (like the standard Windows SERVICES file)</font></li>
  415.     <li><font size="2" face="Arial">Include Aliases as distinct
  416.         line items. (no aliases column)</font></li>
  417.     <li><font size="2" face="Arial">Do NOT include any Alias
  418.         listings.</font></li>
  419.     <li><font size="2" face="Arial">Include (or exclude) reserved
  420.         port listings.</font></li>
  421.     <li><font size="2" face="Arial">Decide which data categories
  422.         to include in the exported list.</font></li>
  423.     <li><font size="2" face="Arial">Optionally, you can exclude
  424.         any references marked as Obsolete from the exported list
  425.         regardless of other associated references.</font></li>
  426. </ul>
  427.  
  428. <hr>
  429.  
  430. <p><a name="Oops"><font face="Arial"><strong>In the event of
  431. accidents:</strong></font></a><font face="Arial"> </font><font
  432. size="2" face="Arial">If at any time the database is hosed beyond
  433. reasonable repair - exit the program and delete the 'dat' folder
  434. (and all of it's contents) that can be found inside the original
  435. program folder. When you go back to the program, the original
  436. database and all of the updated information placed there is
  437. restored from the data found in the INIT folder. (refer to </font><a
  438. href="#Initial"><font size="2" face="Arial">Initialization
  439. Listings</font></a><font size="2" face="Arial"> for more
  440. information) </font></p>
  441.  
  442. <hr>
  443. <div align="center"><center>
  444.  
  445. <table border="0" cellpadding="8" cellspacing="0" width="100%">
  446.     <tr>
  447.         <td align="center" width="33%"><div align="center"><center><table
  448.         border="0" cellpadding="8" cellspacing="0"
  449.         bgcolor="#C0C0C0">
  450.             <tr>
  451.                 <td align="right" valign="top"><font
  452.                 color="#000000" size="1" face="Arial"><strong>Contact:</strong></font></td>
  453.                 <td valign="top"><font color="#000000" size="1"
  454.                 face="Arial"><strong>John Stanley Enterprises</strong><br>
  455.                 PO Box 1672<br>
  456.                 Valrico, FL 33595-1672</font></td>
  457.             </tr>
  458.             <tr>
  459.                 <td align="right" valign="top"><font size="1"
  460.                 face="Arial"><strong>URL:</strong></font></td>
  461.                 <td><a href="http://www.a-znet.com/jse/"><font
  462.                 size="1" face="Arial"><strong>http://www.a-znet.com/jse/</strong></font></a></td>
  463.             </tr>
  464.             <tr>
  465.                 <td align="right" valign="top"><font
  466.                 color="#000000" size="1" face="Arial"><strong>Email:</strong></font></td>
  467.                 <td valign="top"><a href="mailto:urthman@usa.net"><font
  468.                 color="#000000" size="1" face="Arial"><strong>urthman@usa.net</strong></font></a><font
  469.                 color="#000000" size="1" face="Arial"><strong> </strong></font></td>
  470.             </tr>
  471.         </table>
  472.         </center></div></td>
  473.         <td align="center" width="33%"> </td>
  474.         <td align="center" width="33%"><font size="1"
  475.         face="Arial">Microsoft, Windows, NT and Visual Basic are
  476.         registered trademarks of the Microsoft Corporation.</font></td>
  477.     </tr>
  478. </table>
  479. </center></div>
  480. </body>
  481. </html>
  482.